home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 9 / The PC-SIG Library on CD ROM - Ninth Edition.iso / 2301_400 / DISK2324 / DISK2324.ZIP / US_SHARE.ZIP / US_SHARE.DOC < prev    next >
Text File  |  1990-10-12  |  43KB  |  1,170 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                  UltraSearch
  7.                             Shareware Version 1.1
  8.  
  9.                        Index Applications Incorporated
  10.                            8546 Broadway, Suite 208
  11.                             San Antonio, TX 78217
  12.                  voice: (512) 822-4818   fax: (512) 828-5074
  13.  
  14.  
  15.           Copyright (c) 1988, 1990 Index Applications Incorporated.
  16.                 San Antonio, Texas, United States of America.
  17.                              All rights reserved.
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                               LICENSE AGREEMENT
  26.  
  27. Index Applications grants you without charge the right to reproduce,
  28. distribute and use copies of this "shareware" version of our UltraSearch
  29. software product (including the on disk documentation), on the express
  30. condition that you do not receive any payment, commercial benefit, other
  31. consideration for such reproduction or distribution, or change this license
  32. agreement or copyright notice.
  33.  
  34. The rights to receive any such financial or other benefit, and to modify the
  35. product or its components, are reserved exclusively by Index Applications.
  36.  
  37. This software may not be reversed-engineered or disassembled, and includes
  38. certain trade secrets and confidential information of Index Applications.
  39.  
  40. THIS PRODUCT IS LICENSED WITHOUT ANY WARRANTY OF MERCHANTABILITY, FITNESS OF
  41. PARTICULAR PURPOSE, PERFORMANCE, OR OTHERWISE; ALL WARRANTIES ARE DISCLAIMED.
  42. BY USING THE ULTRASEARCH PRODUCT, YOU AGREE THAT NEITHER INDEX APPLICATIONS
  43. INCORPORATED NOR ANY OF ITS EMPLOYEES, AFFILIATES, OWNERS, OR OTHER RELATED
  44. PARTIES WILL BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY USE OF (OR INABILITY
  45. TO USE) THIS SOFTWARE, OR FOR ANY DAMAGES WHATSOEVER. EVEN IF WE ARE APPRISED
  46. OF POSSIBILITY OF SUCH DAMAGES OCCURRING.
  47.  
  48.  
  49.  
  50.  
  51.  
  52. UltraSearch is a  trademark of Index Applications Incorporated.
  53. dBASE is a registered trademark of Ashton-Tate.
  54.  
  55.  
  56.                                  USER SUPPORT
  57.  
  58.                         Problems and Technical Support
  59.  
  60. In the event you have problems with UltraSearch, please read this manual
  61. first to make sure you do understand everything. If you are unable to resolve
  62. the situation take the time to contact us and explain your problem to us.
  63. Make sure that you include the following information to help us evaluate the
  64. problem:
  65.  
  66. 1.    Version of DOS used
  67. 2.    Machine type, memory, monitors, etc.
  68. 3.    Any application executed before UltraSearch
  69. 4.    Your address and telephone number
  70. 5.    Where and how you obtained UltraSearch
  71. 6.    Which version of UltraSearch you are using
  72.  
  73.  
  74.                                    Updates
  75.  
  76. UltraSearch is a dynamic, constantly changing program. For registered users,
  77. our update policy is that all future releases of this product will be made
  78. under a minimal cost policy.
  79.  
  80.  
  81.                             Shareware Registration
  82.  
  83. This is a shareware version of UltraSearch, so you are encouraged to try it
  84. out and make copies for friends.  If you like the program and continue to use
  85. it, we ask that you become a registered user. Registration is only $39 and
  86. includes a diskette containing a registered version of the program, vinyl
  87. binder, printed documentation, and program support. Support from users
  88. enables us to develop additional features and future versions of the
  89. UltraSearch product.
  90.  
  91. We provide information about future upgrades to all registered users. Texas
  92. residents please add $3.21 Sales Tax.  To register, send check, money order
  93. or credit card (Visa/MC) information to:
  94.  
  95.                        Index Applications Incorporated
  96.                            8546 Broadway, Suite 208
  97.                            San Antonio, TX   78217
  98.                                      USA
  99. or call:                       (512) 822-4818
  100.                                (800) 334-8099
  101. or fax:                        (512) 828-5074
  102.  
  103. If you decide not to register because the program is missing a feature that
  104. you require, or does not work with your computer or printer, please let us
  105. know.  We want to fix these kinds of problems whenever possible, so please,
  106. take a few minutes and tell us about them.
  107.  
  108.                       -------------------------------------
  109.                       UltraSearch Registration Payment Form
  110.                       -------------------------------------
  111.  
  112.         To order UltraSearch, please fill out the form below. Use street
  113.         address only (we cannot ship to a post office box).
  114.  
  115.                                                       Date: _____________
  116.  
  117.         Name: _____________________________  Title:   ___________________
  118.  
  119.         Company: ________________________________________________________
  120.  
  121.         Address: ________________________________________________________
  122.  
  123.         _________________________________________________________________
  124.  
  125.         City: ___________________________________________________________
  126.  
  127.         State/Country: ________________________ Zip: ____________________
  128.  
  129.         Phone  Work: (_____) _____ - ______  Home: (_____) _____ - ______
  130.  
  131.  
  132.         Method of payment: Please complete the worksheet below and choose
  133.         one of the payment options indicated. Texas State residents
  134.         must add sales tax. ALL CHECKS AND MONEY ORDERS MUST BE DRAWN ON
  135.         U.S. ACCOUNTS ONLY.
  136.  
  137.  
  138.         +----------+------------------------------+----------+----------+
  139.         |          |                              |   Cost   |   Total  |
  140.         | Quantity |          Description         | per unit |   Cost   |
  141.         +==========+==============================+==========+==========+
  142.         |          |                              |          |          |
  143.         |          |  UltraSearch Package         |  $39.00  |          |
  144.         |          |                              |          |          |
  145.         +==========+=+============================+==========+==========+
  146.                      | Texas residents add sales tax (8.25%) |          |
  147.                      +---------------------------------------+----------+
  148.                      | Shipping Cost(UPS Ground) add $4.00 ea|          |
  149.                      +---------------------------------------+==========+
  150.                                                        TOTAL |          |
  151.         Please indicate diskette format:  [ ] 5.25           +==========+
  152.                                           [ ] 3.5
  153.  
  154.          [ ] Check with order  [ ] Money Order  [ ] MasterCard  [ ] VISA
  155.  
  156.         Credit card #:______________________________ Exp. Date: ____/____
  157.  
  158.         Signature: ______________________________________________________
  159.  
  160.         Cardholder's name: ______________________________________________
  161.  
  162.         Cardholder's address: ___________________________________________
  163.         (If different from above)
  164.         *****************************************************************
  165.         Send all items to:     Index Applications
  166.                                UltraSearch Order Department
  167.                                8546 Broadway, Suite 208
  168.                                San Antonio, TX 78217 USA
  169.         *****************************************************************
  170.         If you have any questions, please call 512-822-4818. Volume users
  171.         of UltraSearch please inquire about quantity discounts.
  172.  
  173.                                  --------------
  174.                                   COMMENT FORM
  175.                                  --------------
  176.  
  177.         Your comments about this software and documentation are welcome.
  178.         Please take the time to fill out this form or write or call us
  179.         with your comments.
  180.  
  181.         Name: _____________________________  Title:   __________________
  182.  
  183.         Company: _______________________________________________________
  184.  
  185.         Address: _______________________________________________________
  186.  
  187.         ________________________________________________________________
  188.  
  189.         City: __________________________________________________________
  190.  
  191.         State/Country: ________________________ Zip: ___________________
  192.  
  193.         Phone Work: (_____) _____ - ______  Home: (_____) _____ - ______
  194.  
  195.         UltraSearch Version #: _________  Exe File Date: _______________
  196.  
  197.  
  198.         ________________________________________________________________
  199.  
  200.         ________________________________________________________________
  201.  
  202.         ________________________________________________________________
  203.  
  204.         ________________________________________________________________
  205.  
  206.         ________________________________________________________________
  207.  
  208.         ________________________________________________________________
  209.  
  210.         ________________________________________________________________
  211.  
  212.         ________________________________________________________________
  213.  
  214.         ________________________________________________________________
  215.  
  216.         ________________________________________________________________
  217.  
  218.         ________________________________________________________________
  219.  
  220.         ________________________________________________________________
  221.  
  222.         ________________________________________________________________
  223.  
  224.  
  225.         *****************************************************************
  226.         Send this form to:     Index Applications
  227.                                UltraSearch Comments
  228.                                8546 Broadway, Suite 208
  229.                                San Antonio, TX 78217 USA
  230.         *****************************************************************
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.                                  UltraSearch
  242.  
  243.            Copyright (c) 1988,1990 Index Applications Incorporated
  244.                              All Rights Reserved
  245.  
  246.                        Index Applications Incorporated
  247.                            8546 Broadway, Suite 208
  248.                             San Antonio, TX 78217
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.                      Shareware Diskette Documentation
  256.                      --------------------------------
  257.  
  258.                                  Introduction
  259.  
  260. Welcome to UltraSearch. You have just substantially improved your ability to
  261. make inquiries on your dBASE database files. You can now search data faster,
  262. more easily, and more effectively than you ever imagined possible. Key
  263. features you can take advantage of include:
  264.  
  265. - Creating a small index file, which stays small even if you include every
  266. field in your database.
  267.  
  268. - Easily designing the display screen, including only the fields you select;
  269. use your usual word processor if you wish.
  270.  
  271. - Permitting the viewer to update data. Maintenance of the index file is
  272. automatic and instant if an update is performed.
  273.  
  274. - Instantly finding the data you search.
  275.  
  276. - Completing complicated inquiries without complicated command syntax (just
  277. type the character, word or phrase and press the Enter key).
  278.  
  279. As powerful as UltraSearch is, you will still find it easy to learn and easy
  280. to use.
  281.  
  282.  
  283.                                    Overview
  284.  
  285. Whether you are working with hundreds of records or tens of thousands of
  286. records, you probably went through the effort to create the database so that
  287. you could get useful information out of your computer later. dBase III
  288. provided you with several features to simplify data entry, but consider what
  289. the following UltraSearch features can do for your ability to extract
  290. information:
  291.  
  292.     UltraFast
  293.  
  294. UltraSearch utilizes an extremely powerful and efficient indexing technology
  295. that can index a 35,000 record file in less than 5 minutes. All the fields
  296. you select for indexing are included in a single index file. Even though you
  297. may elect to include all your database fields, the UltraSearch index will
  298. occupy a maximum of only 32 bytes per record. There is no practical limit to
  299. the data you may include in this index. This small index is the real secret
  300. behind the lightning speed of UltraSearch.
  301.  
  302.     Free Form Searches
  303.  
  304. You know there are several entries for wire cutters in the inventory file
  305. you've created, but SEEK, FIND, and LOCATE fail to turn up the description
  306. you're looking for. The problem is you can't remember the exact description.
  307. This is how UltraSearch works; your description field may look like any of
  308. these:
  309.  
  310.           Cutters, Wire/Cable, Electric
  311.           Electrical Cutters, Wire/Cable
  312.           Wire/Cable Cutters, Electrical
  313.  
  314. ...and yet any of the following UltraSearch inquiries would locate your
  315. record:
  316.  
  317.        Search> wire cutters
  318.        Search> w cut
  319.        Search> electric cut
  320.        Search> cutter elect
  321.  
  322.    Easy to Use
  323.  
  324. Maybe you tried creating several fields to remedy the problem of the wire
  325. cutters, described above. UltraSearch combines all of these fields in a
  326. single index file. If your file looks like this:
  327.  
  328.        Field #1       Field #2          Field # 3
  329.        Cutters Wire   Electrical Wire   Electrical Cutters
  330.  
  331. ...Your UltraSearch inquiry to search across fields #1, #2 and #3 looks like
  332. this:
  333.  
  334.        Search> wire cutters
  335.  
  336. Note: "wire cutters," of course, could be replaced with a nearly infinite
  337. number of free form inquiries.
  338.  
  339.  
  340.  
  341.    Upper/Lower Case Flexibility
  342.  
  343. UPPER/lower case, or any combination, doesn't matter to UltraSearch. This
  344. eliminates another bit of "command syntax". The familiar:
  345.  
  346.       "LOCATE FOR UPPER(FIELDNAME)=WIRE CUTTERS"
  347.  
  348. is replaced with any of the following:
  349.  
  350.       Search> wire cutters
  351.       Search> Wire Cutters
  352.       Search> WIRE CUTTERS
  353.  
  354.  
  355.    Partial Word Searches
  356.  
  357. Carter Building or John Cartier Building?  You want to ask dBASE to find the 
  358. address in the "Cart- something Building".  Even
  359.  
  360.        LOCATE FOR UPPER(SUBSTR(ADDRESS,1,4))="CART"
  361.  
  362. won't help if "John Cartier Building" was actually entered in your
  363. database. The UltraSearch Inquiry:
  364.  
  365.       Search> cart building
  366.  
  367. But was it in the ADDRESS field or the BUILDING field? It doesn't
  368. matter, because UltraSearch checks both--at the speed of an indexed search!
  369.  
  370.  
  371.    UltraFlexible
  372.  
  373. You can use dBASE LOCATE to find information in any field, as long as you
  374. remember at least the first few letters and remember the command syntax
  375. exactly. But what if time is a factor? Since dBASE can handle only 7 indices
  376. at one time, reindexing before you inquire is slow. It seems like you can't
  377. win.
  378.  
  379. UltraSearch lets you index on every field you wish and the index file
  380. occupies a maximum of just 32 bytes per record, regardless of the size of
  381. your record, or the number of index fields!
  382.  
  383.  
  384.    Data Security
  385.  
  386. What do you do when you want several work stations to inquire on your
  387. database? You're not ready for the complexity of a Local Area Network, but
  388. you don't want to buy several copies of dBASE either.
  389.  
  390. The UltraSearch solution: continue to use your dBASE programs at your
  391. primary data entry station. Then copy the entire file or selected records
  392. to other work stations for inquiry or maintenance using UltraSearch.
  393. Compare the price for several copies of UltraSearch to the same for
  394. dBASE.
  395.  
  396.  
  397.    Diverse Application
  398.  
  399. It doesn't matter if you are concerned with parts and inventory files,
  400. personnel and human resources files, mailing lists, or customer tracking
  401. files: UltraSearch will vastly improve your inquiry capability on any
  402. dBASE database file you create.
  403.  
  404.  
  405.    Versatile Screen
  406.  
  407. You define the appearance of your UltraSearch inquiry display. When you
  408. do, you determine not only where fields are displayed, but which fields
  409. are displayed. In fact, you may create several different versions of the
  410. UltraSearch display for use at various work stations.
  411.  
  412.  
  413.    Update Capability
  414.  
  415. Once you have located a record with UltraSearch, you have total update
  416. capability. You can add new records, mark records for deletion or change
  417. records as you wish. The UltraSearch index file is updated automatically.
  418.  
  419. Getting what you need out of your computer is the most important function of
  420. your database file. Getting information out of your computer is what
  421. UltraSearch is all about.
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431. About this documentation file...
  432.  
  433. This file is divided into sections, which we hope will enable you to receive
  434. exactly the amount of help you need. Since UltraSearch is intended for
  435. computer novices and gurus alike, this presents something of a challenge, but
  436. here goes...
  437.  
  438. Section 1, Getting Started, will tell you how to copy UltraSearch onto your
  439. hard disk.
  440.  
  441. Section 2, Setting Up, will introduce you to the general requirements of
  442. UltraSearch and tell you how to prepare UltraSearch for handling your
  443. particular database files.
  444.  
  445. Section 3, Reference, goes straight to the heart of each UltraSearch command.
  446.  
  447. Section 4, System Messages & Problem Solving, explains the meaning and the
  448. significance of the various messages you may receive from UltraSearch.
  449.  
  450.  
  451.                           Section 1, Getting Started
  452.  
  453. Installing UltraSearch. Getting UltraSearch into your computer is as easy
  454. as copying the contents of the distribution diskette into your SEARCH
  455. directory and adding C:\SEARCH to the PATH command in your AUTOEXEC.BAT
  456. file. If you're not familiar with DOS commands, this is how it's done:
  457.  
  458.  
  459. 1. Before you do anything else, make a backup copy of the distribution
  460. diskette C>DISKCOPY A: A:
  461.  
  462. The computer will ask you to place the SOURCE diskette in Drive A.
  463. Insert the distribution diskette and press <Enter>.
  464.  
  465. After reading the disk drive for a minute, the computer will ask you to
  466. place the TARGET diskette in Drive A. Insert your blank diskette and press
  467. <Enter>. If it's not already formatted, the operating system will take
  468. care of that automatically.
  469.  
  470.  
  471. 2. At the DOS prompt, make a directory to store your UltraSearch files:
  472.  
  473.       C>CD \        (change to the Root directory)
  474.       C>MD SEARCH   (create SEARCH directory)
  475.       C>CD SEARCH   (change to SEARCH directory)
  476.  
  477. Note: when you type these commands, the computer won't "do" anything,
  478. but the current directory will then be SEARCH.
  479.  
  480.  
  481. 3. Copy the contents of the distribution diskette:
  482.  
  483.       C>copy a:*.*
  484.  
  485. 4. Edit the PATH command in your AUTOEXEC.BAT file using either EDLIN,
  486. your own DOS text editor, or your favorite word processing program if it
  487. has ASCII file import and export capabilities. The PATH command will look
  488. something like this:
  489.  
  490.        PATH C:\DOS;C:\DBASE
  491.  
  492. All you need to do is tack on our new directory as follows:
  493.  
  494.        PATH C:\DOS;C:\DBASE;C:\SEARCH
  495.  
  496.  
  497.    Text Editor
  498.  
  499. Before actually running UltraSearch on a database file, you may find it
  500. helpful to customize a specialized file called a "template," which is a DOS
  501. text (ASCII) file defining your UltraSearch file display layout. While we
  502. will be describing this at some length shortly, it is worth mentioning
  503. "text" editors. The editor you use may be any of the following:
  504.  
  505.    dBASE MODIFY COMMAND
  506.  
  507. You may be familiar with this command used to activate the dBASE text
  508. editor. It is fine for our purposes.
  509.  
  510.  
  511.    Your Word Processor
  512.  
  513. Most word processors enable you to save files in a generic text
  514. format. They may call it an "ASCII" save or "DOS text" file, but the main
  515. thing is that they strip away the special characters unique to that word
  516. processor.
  517.  
  518.    Programmer's Text Editors
  519.  
  520. Most of the text editors intended for programmers produce exactly the
  521. kind of generic text we've been talking about.
  522.  
  523.    EDLIN
  524.  
  525. If you don't have access to anything else, EDLIN will do. This is a
  526. single-line editor provided with the DOS operating system, which is
  527. adequate for the minimal requirements of your template file.
  528.  
  529.  
  530.  
  531.                                File Extensions
  532.  
  533. A DOS filename may include a 3-character "extension", which is
  534. sometimes used by software such as dBASE and UltraSearch to identify
  535. particular types of files. There are five file extensions with special
  536. meaning to UltraSearch:
  537.  
  538.     .DBF (database file)
  539.  
  540. This extension is added automatically by dBASE when you create a
  541. database file. This convention is not required by UltraSearch; dBASE
  542. database files with any extension may be used.
  543.  
  544.     .TP (template)
  545.  
  546. This extension is required so that UltraSearch can find the template
  547. file which corresponds to the database file you select.
  548.  
  549.     .INF (information)
  550.  
  551. Files with this extension are created by UltraSearch automatically
  552. when you select a database file with no corresponding template (TP)
  553. file. This file is intended for your convenience only; it is a
  554. reference to the structure of your database to be used in creating your
  555. template file. If you don't need this file, you can delete it at any
  556. time. It is not required by UltraSearch.
  557.  
  558.     .IA (UltraSearch index)
  559.  
  560. The index files serve the same purpose for UltraSearch that you have
  561. seen in dBASE; it makes finding data much faster. You may be
  562. accustomed to having several index files for various purposes.
  563. UltraSearch requires only one, regardless of the type of search you wish
  564. to perform.
  565.  
  566.     .EXE (UltraSearch Program File)
  567.  
  568.    US.EXE - This is the executable UltraSearch program file.
  569.  
  570.  
  571.                       Section 2, Setting up UltraSearch
  572.  
  573.  
  574.    Overview to UltraSearch Setup
  575.  
  576. UltraSearch is not intended for creating new databases (but watch for
  577. future releases which may). Therefore, we have to assume you already have
  578. a database file in place. In addition to an existing database file, a
  579. "template" file is required by UltraSearch. This template serves two
  580. purposes; it
  581.  
  582. 1) defines the way the display screen will appear as you use
  583. UltraSearch, and
  584.  
  585. 2) enables you to mark the fields which are to be included in the
  586. UltraSearch index (for subsequent searches).
  587.  
  588. UltraSearch creates a template file automatically and assumes that you
  589. would like to index all fields in the record. It is likely, however, that
  590. you will want to customize the appearance of your record display, or
  591. exclude one or more fields from the UltraSearch index.
  592.  
  593.  
  594.    Template Files
  595.  
  596. A template file is used to tell UltraSearch exactly how you want the
  597. display screen to look. UltraSearch creates a template file automatically,
  598. using the file extension, ".TP". Customizing the appearance of your
  599. UltraSearch display is simply a matter of editing this file using your text
  600. editor or word processor like we did on the one presented here:
  601.  
  602. ________________________________________________________________________
  603.  
  604. \number\              BIBLIOGRAPHIC INFORMATION SYSTEM
  605.  
  606. TITLE:
  607. \*title1\
  608. \*title2\
  609. \*title3\
  610.  
  611. AUTHOR(S):
  612. \*author1\           \*author4\        \*author7\
  613. \*author2\           \*author5\        \*author8\
  614. \*author3\           \*author6\        \*author9\
  615.  
  616. CITATION:
  617. \*citation1\
  618. \*citation2\
  619.  
  620. ANNOTATION:
  621. \*annotate1\
  622. \*annotate2\
  623. \*annotate3\
  624. \*annotate4\
  625.  
  626. ________________________________________________________________________
  627.  
  628. We used upper case letters to distinguish between descriptive text and actual
  629. field names, but this is not an UltraSearch requirement.
  630.  
  631.  
  632. The following points are all you need to remember in editing your template
  633. file:
  634.  
  635. - Field names from the dBASE file are entered between backslashes (\);
  636.  
  637. - The first backslash represents the starting position for the
  638. displayed data;
  639.  
  640. - Anything not typed between backslashes will appear exactly as typed;
  641.  
  642. - You must leave space for display of the entire field; overlapping
  643. fields will prevent UltraSearch from running;
  644.  
  645. - Fields which are to be included in the UltraSearch index are preceded
  646. by an asterisk (*) (in our example, we included all but one, with no
  647. increase in the size of the index!);
  648.  
  649. - Fields which are to be displayed but not included in the UltraSearch
  650. index are entered between backslashes (\) without an asterisk (*);
  651.  
  652. - The template file, and subsequently your display, may be a total of
  653. 21 lines in length (to leave room for UltraSearch messages and input);
  654.  
  655. - If there is not room for an entire field before the end of the
  656. display, the field will appear truncated, but the entire field is
  657. indexed and is searchable.
  658.  
  659.  
  660.                        Section 3, UltraSearch Reference
  661.  
  662.  
  663. Starting UltraSearch.
  664.  
  665. Typically, you would start UltraSearch from the directory which contains
  666. your database and template files. UltraSearch is started at the DOS prompt
  667. with the command:
  668.  
  669.    C>US FILENAME
  670.  
  671. FILENAME, of course, would be the name of your database file. The
  672. extension, .DBF, is not required, but if you have changed the standard
  673. extension to something else, you must include it.
  674.  
  675.  
  676.    UltraSearch Commands.
  677.  
  678. UltraSearch commands are activated by pressing one of the cursor control
  679. keys or the character keys described here. You may also use the light bar
  680. menu displayed at the bottom of the UltraSearch display. Use the right and
  681. left arrow keys, or the first letter of each command to make menu
  682. selections.
  683.  
  684.  
  685.    Creating an UltraSearch Index (I).
  686.  
  687. A database file must be indexed by UltraSearch before you can use the
  688. Search command, but the basic browsing and editing options will work even
  689. before the UltraSearch index is created. When you press the letter, I,
  690. UltraSearch will check to see if an index for this file already exists. If
  691. an index file does already exist, UltraSearch will ask you to verify (Y
  692. or N) before continuing. The old index will be replaced, if you select Y.
  693.  
  694. CAUTION: UltraSearch index files are not updated when you add or modify
  695. records using dBASE. Therefore, you must use Index to update your
  696. UltraSearch index, if the file has been updated using dBASE since the last
  697. UltraSearch index operation.
  698.  
  699.  
  700.    Search (S).
  701.  
  702. The search option is the most powerful feature of UltraSearch. It is
  703. both fast and easy to use.
  704.  
  705.  
  706.    Search All Occurrences.
  707.  
  708. When you press the letter, S, UltraSearch will display a search
  709. prompt. Simply type the word or words (up to 70 characters) that you are
  710. looking for and press <Enter>; UltraSearch will check all indexed fields
  711. for matching records.
  712.  
  713.  
  714. If you specify more than one word, UltraSearch will assume you mean
  715. find all records containing both (or all) specified words. Therefore,
  716. if you specify "san francisco" you won't be retrieving "san diego". This
  717. also means that if you search for the name "ed brown", UltraSearch will
  718. also locate a record with a street name "twistED rock" in "BROWNsville"
  719. if all these fields are included in the index and you don't get more
  720. specific.
  721.  
  722.  
  723.    Recalling Your Last Search.
  724.  
  725. If you want to recall the last search string entered, simply push the F1 key 
  726. from within the search mode. This is useful when you wish to modify the last 
  727. search slightly, or if you would like to re-invoke the last search without 
  728. typing the search string again.
  729.  
  730.  
  731.    Getting More Specific.
  732.  
  733. To limit the scope of a search to a particular field, simply add a tilde (~) 
  734. and field number to the word (with no blank space). For example, if NAME 
  735. (field #4) and CITY (field #8) are both included in the index:
  736.  
  737.       brown~4  will find Ed Browning
  738.                but not Brownsville TX
  739.  
  740.       brown~8  will find Brownsville TX
  741.                but not Ed Browning
  742.  
  743. Note: The Layout (L) option is useful as a field number reference. You can 
  744. determine the field number and check to see if a particular field is included 
  745. in the index. You may wish to print the layout screen (using the DOS Print 
  746. Screen function) for future reference when building a complex search.
  747.  
  748. The vertical line (|) may be used to specify characters which occur only at 
  749. the beginning or end of a word, for example:
  750.  
  751.       |co   will find Randy Coleman
  752.             but not San Francisco
  753.  
  754.       co|   will find San Francisco
  755.             but not Randy Coleman
  756.  
  757.       |San| will find San Francisco
  758.             but not Santa Fe Browsing Options.
  759.  
  760. Do not be confused by a distinct difference between a dBASE indexed file
  761. and an UltraSearch indexed file: after UltraSearch indexing, your database
  762. file will still appear in its original record order.
  763.  
  764.  
  765.    Top/Bottom of File
  766.  
  767. The HOME and END keys are used to advance instantly to the top of the
  768. database file or to the end of the file respectively.
  769.  
  770.  
  771.    Next Record in File
  772.  
  773. The DOWN arrow (cursor control key) or the space bar may be used to advance
  774. to the next record in the data base file by record number sequence. This does
  775. not interfere with the Next and Previous Find options, which enable you to
  776. browse through records found in the current Search. When you reach the bottom
  777. of the file, UltraSearch automatically continues with record number 1 (as if
  778. the file were circular). Watch the record number counter in the lower right
  779. corner.
  780.  
  781.  
  782.    Previous Record in File
  783.  
  784. The UP arrow (cursor control key) is used to move to the previous record in
  785. the database file by record number sequence. This does not interfere with
  786. the Next and Previous Find options, which enable you to browse through
  787. records found in the current Search. When you reach the top of the file,
  788. UltraSearch automatically continues with the last record in the file (as if
  789. the file were circular). Watch the record number counter in the lower right
  790. corner.
  791.  
  792.  
  793.    Next Find (N)
  794.  
  795. Press the letter, N, to advance to the next occurrence of the word(s) found
  796. by a search. UltraSearch will continue to advance until it displays the
  797. message, "No More".
  798.  
  799.  
  800.    Previous Find (P)
  801.  
  802. Press the letter, P, to move to the previous occurrence of the word(s) found
  803. by a search. UltraSearch will continue in this fashion until the message,
  804. "No Previous". is displayed.
  805.  
  806.  
  807.    Move to Record Number (M)
  808.  
  809. Even after indexing, your records will appear in their original record
  810. sequence (the order in which they were added). When you press the letter, M,
  811. UltraSearch will ask you to specify a record number. Type the record number
  812. and press enter. It is similar to the dBASE GOTO command.
  813.  
  814.  
  815.    Editing (E)
  816.  
  817. When you press the letter, E, UltraSearch enters "edit" mode. Use the
  818. arrow keys to move to the field you wish to edit. The "current" field will
  819. appear in reverse video. Press the Enter key to save the change and leave
  820. edit mode or press Escape to cancel the change.
  821.  
  822.  
  823.                             Keyboard Definitions
  824.  
  825. The following table lists the editing functions available when in edit
  826. mode:
  827.  
  828.       Edit Function               Predefined Key(s)
  829.  
  830.       Delete Character                 Del
  831.       Delete Previous Character        Backspace
  832.       Delete Field                     Ctrl-End
  833.       Delete Word                      F5
  834.       Delete to End of Line            F6
  835.       Exit Without Saving              Esc
  836.       Exit After Saving                Enter
  837.       Insert Mode Toggle               Ins
  838.       Move to Next Word                End
  839.       Move to Previous Word            Home
  840.       Move to Start of Field           F3
  841.       Move to End of Field             F4
  842.       Move to Previous Field           Up Arrow or Shift-TAB
  843.       Move to Next Field               Down Arrow or TAB
  844.       Move Forward                     Right Arrow
  845.       Move Backwards                   Left Arrow
  846.       Save then Add New Record         F7
  847.       Save then Edit Next Record       PgDn
  848.       Save then Edit Previous Record   PgUp
  849.       Toggle Record as Deleted         F9
  850.       Transpose Characters             F8
  851.  
  852.  
  853.  
  854.                                      Help
  855.  
  856. Help is available in several forms. There is a general UltraSearch
  857. command reference as well as a file reference to help you determine field
  858. numbers and identify index keys.
  859.  
  860.  
  861.    General Command Reference (H)
  862.  
  863. When you press the letter, H, UltraSearch displays a one-page display
  864. of all of the keys used to activate the various UltraSearch Commands.
  865. You may press any key to exit this display.
  866.  
  867.  
  868.    Field Names (F)
  869.  
  870. Pressing the letter, F, will produce a list of all the fields in your
  871. database. Those which have been selected for display and indexing will
  872. have boldfaced field numbers; those selected for display only will have
  873. field numbers in reverse video; those not selected for display or
  874. indexing will have field numbers displayed in normal mode. To change
  875. these selections, you must exit UltraSearch and edit your template file.
  876.  
  877.  
  878.    Layout (L)
  879.  
  880. The layout display, activated by pressing the letter, L, is similar in
  881. function to the field name list described in the previous paragraph.
  882. The difference is that only fields selected for display are shown. A
  883. number indicates that the field is included in the index and may be
  884. used in defining the scope of a search. If a one byte field is indexed
  885. and has a double digit field number, the field will be displayed with a
  886. letter (A-Z) and a cross- reference for that letter will be displayed at
  887. the bottom of your screen. A field which is not included in the index
  888. will be filled with X's.
  889.  
  890.  
  891.     Write Results (W)
  892.  
  893. This option may only be used after specifying your search criteria using
  894. option S (search). Press W and UltraSearch will ask you to type a name for
  895. the new database file to which all records found by the search will be
  896. copied. The name you use must be eight characters or less in length, may
  897. not include a period or any spaces, and may not include an extension.
  898. UltraSearch will add the extension, ".DBF". If you had customized the
  899. original template file, you could use the DOS Copy command to create a
  900. template for the new file.
  901.  
  902.       COPY FILENAME.TP NEWFILE.TP
  903.  
  904. where FILENAME.TP is your original template file and NEWFILE.TP is the
  905. name of the new template file.
  906.  
  907. You will also need to Index the new file before doing any searches.
  908.  
  909.  
  910.     Quit (Q)
  911.  
  912. You may exit UltraSearch at any time by simply pressing the letter, Q.
  913. You will be asked to confirm this selection (Y, exit, or N, cancel).
  914. Remember that if you made any changes to data which might affect your dBASE
  915. indices, you may want to re-index your dBASE file.
  916.  
  917.  
  918.                 Section 4, System Messages & Problem Solving
  919.  
  920.                                System Messages
  921.  
  922. The following is an alphabetic listing of messages which you may receive
  923. from UltraSearch from time to time. Many of these do not denote errors;
  924. they are simply informative messages to make sure everything is in order.
  925. Most are self-explanatory, but you may want to read these notes to
  926. understand the full implication of these messages.
  927.  
  928.  
  929.     Already indexed. Are you sure?
  930.  
  931. Each time you index the file, UltraSearch will overlay the previous
  932. index file. This message lets you verify that this is what you wish to
  933. do. Replacing the original index is necessary any time there is a change
  934. made to an indexed field by software other than UltraSearch.
  935.  
  936.  
  937.     Bad Command or File Name
  938.  
  939. This is actually a DOS error message indicating that the operating
  940. system doesn't recognize the command entered. If the current directory
  941. is not SEARCH, then SEARCH must be added to the path command (see
  942. Installing UltraSearch). This error would also occur if you omitted the
  943. space between USDEMO and the FILENAME.
  944.  
  945.  
  946.     Creating index
  947.  
  948. This flashing message will continue until the new index is complete. A
  949. counter in the center of the status line will indicate the number of
  950. records indexed (in increments of 100). If you abort the index,
  951. UltraSearch will prevent you from searching on the incomplete index
  952. file.
  953.  
  954. CAUTION: If you exit UltraSearch after aborting indexing, you could
  955. reactivate UltraSearch without reindexing. However, this would be
  956. inadvisable since the index would not be complete and any search might be
  957. inaccurate.
  958.  
  959.  
  960.     Creating New .DBF file Finished. XXXXXX records written
  961.  
  962. This message flashes when you use the Write Results (W) command to
  963. copy searched records and will continue until the new database file has
  964. been completed. The counter will increment as each record is added to the
  965. new file.
  966.  
  967.  
  968.     File is indexed
  969.  
  970. CAUTION: This message tells you that an index exists, but does not
  971. verify that the index is current. If changes have occurred in the
  972. database since the last time you used UltraSearch, you must Index the file
  973. again.
  974.  
  975.  
  976.     File name for output (no extension)
  977.  
  978. When you select option W (Write), you must name the new database file.
  979. Use only eight or fewer characters, with no spaces or periods.
  980.  
  981.  
  982.     Illegal constraint field
  983.  
  984. A constraint limits the scope of a search to a particular field. The
  985. word to be searched must be followed by a tilde (~) and field number.
  986. Option L (Layout) will provide you with a display of valid field
  987. numbers. This message indicates that you have selected a
  988. non-indexed field or typed a tilde (~) without specifying a field
  989. number.
  990.  
  991.  
  992.     More than 22 lines in the template file. Please shorten to 22 lines
  993.     or less.
  994.  
  995. The size of the display area is limited to prevent
  996. interference with the display of file information and messages. Use
  997. your text editor to modify the template file.
  998.  
  999.  
  1000.     No More
  1001.  
  1002. This indicates that you have reached the last record matching
  1003. your search criteria.
  1004.  
  1005.  
  1006.     No previous
  1007.  
  1008. This tells you that no records before the displayed record
  1009. match your search criteria.
  1010.  
  1011.  
  1012.     No search in progress
  1013.  
  1014. This message will appear if you select N (Next Find) or P
  1015. (Previous Find) without first specifying your search criteria. Use
  1016. option S (Search) first, then use these options to browse
  1017. through selected records. The up and down arrows (or space bar) are
  1018. used to advance through the database by record number,
  1019. regardless of search criteria.
  1020.  
  1021.  
  1022.     No search results to use
  1023.  
  1024. You may not use option W (Write) without first using option S
  1025. (Search) to specify which records you wish UltraSearch to copy to
  1026. another file.
  1027.  
  1028.  
  1029.     Null string after constraint field removed
  1030.  
  1031. This message tells you that you have typed an extra blank
  1032. space between the tilde (~) and the field number.
  1033.  
  1034.        Correct     Incorrect
  1035.  
  1036.        brown~3     brown  ~3
  1037.  
  1038.  
  1039.     Overlapping field 'MI' on line 4 of template file
  1040.  
  1041. In laying out your template file, you must be sure to leave
  1042. room for display of all fields. This message was produced by placing
  1043. the middle initial (MI) too close to the first name (FIRST),
  1044. which was fourteen characters in length.
  1045.  
  1046. NAME: \*FIRST\ \MI\ \*LAST\
  1047.  
  1048. This problem was corrected by repositioning the fields as
  1049. follows:
  1050.  
  1051. NAME: \*FIRST\ \MI\ \*LAST\
  1052.  
  1053.  
  1054.     Possible file change. Please re-index if this has occurred.
  1055.  
  1056. This message will only appear when you first activate
  1057. UltraSearch, indicating that the index file may not match the database
  1058. file. If you exit without indexing you will not receive this
  1059. message again when you reactivate UltraSearch.
  1060.  
  1061.  
  1062.     Record number is out of bounds
  1063.  
  1064. Option M (Move to Record Number) prompts you to enter a record
  1065. number between 1 and the last record number in the file, which is
  1066. displayed in parenthesis. This message indicates you entered a
  1067. number beyond this range or a letter (which equals 0).
  1068.  
  1069.  
  1070.     No template file ('DEMO.TP') found, so am creating the 
  1071.     file 'DEMO.INF' which is an information file containing 
  1072.     descriptive information about the database which can 
  1073.     be used in creating a template.  A template file 
  1074.     will also be created displaying as many of these fields 
  1075.     as can fit on the screen. Run this program again to use 
  1076.     this template or consult the documentation 
  1077.     for help in creating your own display template.
  1078.  
  1079. UltraSearch has created a .TP (template) file and an .INF
  1080. (information) file for your use. You should re-run USDEMO if you wish
  1081. to use these files.
  1082.  
  1083.  
  1084.     .TP file non-existent but .INF file exists. Overwrite .INF file 
  1085.     (y or n)?
  1086.  
  1087. While attempting to create a template file, UltraSearch found
  1088. an information file already existed. You should answer 'y' if you
  1089. would like UltraSearch to create a display template for you.
  1090.  
  1091.  
  1092.     Unable to create .DBF output file
  1093.  
  1094. Using the Write, W, command, you specified an illegal name for
  1095. the new file; it must be eight or fewer characters, and may not
  1096. contain spaces or a period.
  1097.  
  1098.  
  1099.     Unable to open file 'FILENAME'
  1100.  
  1101. This message occurs when you attempt to run UltraSearch with a
  1102. non-existent file name. Check to see if you spelled the name of the
  1103. file correctly before restarting the program. This error would
  1104. also occur if the file existed, but was not a dBASE file.
  1105.  
  1106.  
  1107.     You must create index prior to searching
  1108.  
  1109. Without the unique UltraSearch index, option S (Search) is not
  1110. functional. You must first select option I (Index) to create the
  1111. required index.
  1112.  
  1113.  
  1114.                                Problem Solving
  1115.  
  1116. Since UltraSearch is primarily concerned with improving a fairly
  1117. specific aspect of database management, there aren't many ways to get in
  1118. trouble; however, we found a few conditions worth mentioning:
  1119.  
  1120.  
  1121.     Cursor control keys appear to stop working
  1122.  
  1123. Check your Num Lock key. If you accidentally press it, there
  1124. will be no visible indication on the screen. The numeric keypad is not
  1125. included in the default configuration file.
  1126.  
  1127.  
  1128.     You have accidentally selected an option you do not wish to use.
  1129.  
  1130. If a message does not say, "Press any key to continue", just
  1131. press the <Enter> key. This blank entry will cancel any command.
  1132.  
  1133.  
  1134.     You have tried to start UltraSearch while dBASE is running and 
  1135.     keep returning to the dBASE dot prompt.
  1136.  
  1137. UltraSearch is probably displaying an error message which is
  1138. immediately overlaid by dBase. You are probably entering the filename
  1139. incorrectly. Be sure and type:
  1140.  
  1141.     US FILENAME
  1142.  
  1143. FILENAME is the name of you database file. The extension is
  1144. not necessary unless it is different from the standard .DBF.
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.                                  UltraSearch
  1154.                             Shareware Version 1.1
  1155.  
  1156.                                     $39.00
  1157.                              Order (800) 334-8099
  1158.  
  1159.                        Index Applications Incorporated
  1160.                            8546 Broadway, Suite 208
  1161.                             San Antonio, TX 78217
  1162.                  voice: (512) 822-4818   fax: (512) 828-5074
  1163.  
  1164.  
  1165. By sending in your payment, together with your name, company name, mailing 
  1166. address, telephone number, version number, and where you heard about 
  1167. UltraSearch and got your copy, we will send you a copy of the latest version 
  1168. of UltraSearch, printed documentation, free technical support and 
  1169. announcements of later releases. Also, please feel free to contribute your 
  1170. ideas regarding desired additional product features and functionality.